@planu/cli 0.28.0 → 0.30.0

package/dist/config/model-routing-rules.json

@@ -0,0 +1,98 @@
+{
+  "version": "1.0.0",
+  "rules": [
+    {
+      "id": "haiku-simple-readonly",
+      "name": "Haiku for simple read-only tasks",
+      "conditions": [
+        { "signal": "criteriaCount", "operator": "lte", "value": 5 },
+        { "signal": "fileCount", "operator": "lte", "value": 3 },
+        { "signal": "isReadOnly", "operator": "eq", "value": true }
+      ],
+      "result": "haiku",
+      "weight": 1.0
+    },
+    {
+      "id": "haiku-search",
+      "name": "Haiku for search/explore tasks",
+      "conditions": [
+        { "signal": "taskType", "operator": "eq", "value": "search" },
+        { "signal": "criteriaCount", "operator": "lte", "value": 5 }
+      ],
+      "result": "haiku",
+      "weight": 0.9
+    },
+    {
+      "id": "sonnet-medium-generation",
+      "name": "Sonnet for medium code generation",
+      "conditions": [
+        { "signal": "criteriaCount", "operator": "between", "value": [6, 15] },
+        { "signal": "taskType", "operator": "eq", "value": "generation" }
+      ],
+      "result": "sonnet",
+      "weight": 0.85
+    },
+    {
+      "id": "sonnet-medium-files",
+      "name": "Sonnet for medium file count tasks",
+      "conditions": [{ "signal": "fileCount", "operator": "between", "value": [4, 10] }],
+      "result": "sonnet",
+      "weight": 0.75
+    },
+    {
+      "id": "sonnet-refactor",
+      "name": "Sonnet for refactoring tasks",
+      "conditions": [
+        { "signal": "taskType", "operator": "eq", "value": "refactor" },
+        { "signal": "crossLayerCount", "operator": "lte", "value": 2 }
+      ],
+      "result": "sonnet",
+      "weight": 0.8
+    },
+    {
+      "id": "opus-high-criteria",
+      "name": "Opus for specs with many criteria",
+      "conditions": [{ "signal": "criteriaCount", "operator": "gt", "value": 15 }],
+      "result": "opus",
+      "weight": 0.9
+    },
+    {
+      "id": "opus-many-files",
+      "name": "Opus for tasks touching many files",
+      "conditions": [{ "signal": "fileCount", "operator": "gt", "value": 10 }],
+      "result": "opus",
+      "weight": 0.85
+    },
+    {
+      "id": "opus-cross-layer",
+      "name": "Opus for cross-layer changes",
+      "conditions": [{ "signal": "crossLayerCount", "operator": "gt", "value": 2 }],
+      "result": "opus",
+      "weight": 0.9
+    },
+    {
+      "id": "opus-architecture",
+      "name": "Opus for architecture design",
+      "conditions": [{ "signal": "taskType", "operator": "eq", "value": "architecture" }],
+      "result": "opus",
+      "weight": 0.95
+    },
+    {
+      "id": "opus-security",
+      "name": "Opus for security-sensitive tasks",
+      "conditions": [
+        { "signal": "hasSecurityImplications", "operator": "eq", "value": true },
+        { "signal": "crossLayerCount", "operator": "gt", "value": 1 }
+      ],
+      "result": "opus",
+      "weight": 0.85
+    },
+    {
+      "id": "sonnet-default",
+      "name": "Sonnet as balanced default",
+      "conditions": [],
+      "result": "sonnet",
+      "weight": 0.5
+    }
+  ]
+}

package/dist/engine/ai-cost-estimator/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/core.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,oBAAoB,EAEpB,mBAAmB,EAEpB,MAAM,sBAAsB,CAAC;AAqS9B;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmF9F"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAqD9B;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmF9F"}

package/dist/engine/ai-cost-estimator/core.js

@@ -1,9 +1,9 @@
 // engine/ai-cost-estimator/core.ts — Orchestrates AI cost estimation for specs.
 // Coordinates token-estimator + model-pricing to produce AiCostEstimateResult.
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
 import { loadPricingConfig, getAllModels, calculateCost, calculateAgentTurns, isPricingStale, } from './model-pricing.js';
 import { buildTokenEstimate } from './token-estimator.js';
+import { loadSpecContent, countAcceptanceCriteria, readUsageAvgTokensPerCall, } from './spec-loader.js';
+import { selectRecommendedModel, buildRecommendationReason, formatMarkdownTable, } from './recommender.js';
 // ---------------------------------------------------------------------------
 // Complexity thresholds
 // ---------------------------------------------------------------------------
@@ -30,206 +30,6 @@ function getComplexityLevel(acCount) {
     return 'high';
 }
 // ---------------------------------------------------------------------------
-// Spec content loading
-// ---------------------------------------------------------------------------
-/**
- * Reads spec content from a sdd/specs directory.
- * Tries to find the spec directory by matching specId prefix.
- */
-async function loadSpecContent(specId) {
-    // Try modern location first, fallback to legacy
-    let specsRoot = 'planu/specs';
-    try {
-        const { access: fsAccess } = await import('node:fs/promises');
-        await fsAccess(specsRoot);
-    }
-    catch {
-        specsRoot = 'docs/sdd/specs';
-    }
-    const { readdir } = await import('node:fs/promises');
-    let specDir = null;
-    try {
-        const topEntries = await readdir(specsRoot);
-        // Try flat layout first: planu/specs/SPEC-069-name/ or docs/sdd/specs/SPEC-069-name/
-        const flatMatch = topEntries.find((e) => e.startsWith(specId));
-        if (flatMatch) {
-            specDir = join(specsRoot, flatMatch);
-        }
-        else {
-            // Try nested layout: planu/specs/{feature}/SPEC-069-name/
-            for (const group of topEntries) {
-                try {
-                    const groupEntries = await readdir(join(specsRoot, group));
-                    const nestedMatch = groupEntries.find((e) => e.startsWith(specId));
-                    if (nestedMatch) {
-                        specDir = join(specsRoot, group, nestedMatch);
-                        break;
-                    }
-                }
-                catch {
-                    // Not a directory — skip
-                }
-            }
-        }
-    }
-    catch {
-        throw new Error(`Spec directory not found at "${specsRoot}". ` +
-            'Make sure you are running from the project root.');
-    }
-    if (!specDir) {
-        throw new Error(`Spec "${specId}" not found in "${specsRoot}". ` + 'Check that the spec directory exists.');
-    }
-    const parts = [];
-    // Try modern names first, fallback to legacy — only read one of each pair
-    for (const [modern, legacy] of [
-        ['spec.md', 'HU.md'],
-        ['technical.md', 'FICHA-TECNICA.md'],
-    ]) {
-        let found = false;
-        for (const filename of [modern, legacy]) {
-            if (found) {
-                break;
-            }
-            try {
-                const content = await readFile(join(specDir, filename), 'utf-8');
-                parts.push(content);
-                found = true;
-            }
-            catch {
-                // File not present — try next
-            }
-        }
-    }
-    if (parts.length === 0) {
-        throw new Error(`Spec "${specId}" has no spec files in "${specDir}". ` +
-            'Cannot estimate without spec content.');
-    }
-    return { content: parts.join('\n\n'), specDir };
-}
-/** Counts acceptance criteria (lines starting with "- [ ]" or "- [x]") in spec content. */
-function countAcceptanceCriteria(specContent) {
-    const matches = specContent.match(/^- \[[ xX]\]/gm);
-    return matches?.length ?? 0;
-}
-// ---------------------------------------------------------------------------
-// Usage calibration
-// ---------------------------------------------------------------------------
-/** Reads average tokens per call from usage.json if available. */
-async function readUsageAvgTokensPerCall() {
-    try {
-        const { readFile: rf } = await import('node:fs/promises');
-        const raw = await rf('data/global/usage.json', 'utf-8');
-        /* v8 ignore start */
-        const log = JSON.parse(raw);
-        if (log.events.length === 0) {
-            return undefined;
-        }
-        // Usage events don't track token counts — return undefined to use defaults
-        return undefined;
-        /* v8 ignore stop */
-    }
-    catch {
-        return undefined;
-    }
-}
-// ---------------------------------------------------------------------------
-// Recommendation logic
-// ---------------------------------------------------------------------------
-/** Selects the recommended model based on spec complexity. */
-function selectRecommendedModel(models, complexity) {
-    const preferencesByComplexity = {
-        low: [
-            'claude-haiku-3-5',
-            'gemini-2-5-pro',
-            'gpt-4-1',
-            'gpt-4o',
-            'claude-sonnet-4',
-            'claude-opus-4',
-        ],
-        medium: [
-            'claude-sonnet-4',
-            'gpt-4o',
-            'gpt-4-1',
-            'gemini-2-5-pro',
-            'claude-haiku-3-5',
-            'claude-opus-4',
-        ],
-        high: [
-            'claude-opus-4',
-            'claude-sonnet-4',
-            'gpt-4o',
-            'gpt-4-1',
-            'gemini-2-5-pro',
-            'claude-haiku-3-5',
-        ],
-    };
-    const preferences = preferencesByComplexity[complexity] ?? preferencesByComplexity.medium ?? [];
-    for (const modelId of preferences) {
-        const model = models.find((m) => m.id === modelId);
-        if (model) {
-            return model;
-        }
-    }
-    // Fallback: cheapest model
-    /* v8 ignore start */
-    const sorted = [...models].sort((a, b) => a.inputPricePerMillion - b.inputPricePerMillion);
-    const first = sorted[0];
-    if (!first) {
-        throw new Error('No models available in pricing config');
-    }
-    return first;
-    /* v8 ignore stop */
-}
-/** Builds a human-readable recommendation reason. */
-function buildRecommendationReason(model, complexity, savingsVsMostExpensive) {
-    const complexityLabel = { low: 'baja', medium: 'media', high: 'alta' }[complexity];
-    const baseReason = `Para complejidad ${complexityLabel}, **${model.displayName}** ofrece `;
-    if (complexity === 'low') {
-        return (baseReason +
-            `el mejor precio sin sacrificar calidad. ` +
-            `Ahorro estimado vs modelo más caro: $${savingsVsMostExpensive.toFixed(4)} USD.`);
-    }
-    if (complexity === 'medium') {
-        return (baseReason +
-            `el mejor balance calidad/precio. ` +
-            `Ahorro estimado vs modelo más caro: $${savingsVsMostExpensive.toFixed(4)} USD.`);
-    }
-    return (baseReason +
-        `máxima calidad para specs complejas. ` +
-        `El costo adicional se justifica por la reducción de iteraciones.`);
-}
-// ---------------------------------------------------------------------------
-// Markdown formatting
-// ---------------------------------------------------------------------------
-/** Formats the cost estimates as a markdown table. */
-function formatMarkdownTable(estimates, recommendedModelId, recommendationReason, staleWarning) {
-    const header = '| Modelo | Tokens Input | Tokens Output | Costo Estimado | Rango (±) | Agent Turns |\n' +
-        '|--------|-------------|---------------|----------------|-----------|-------------|';
-    const rows = estimates.map((est) => {
-        const marker = est.modelId === recommendedModelId ? ' ⭐' : '';
-        const cost = `$${est.estimatedCostUsd.toFixed(4)}`;
-        const range = `±${est.confidenceRangePct}%`;
-        return (`| ${est.displayName}${marker} | ${est.inputTokens.toLocaleString()} | ` +
-            `${est.outputTokens.toLocaleString()} | ${cost} | ${range} | ${est.agentTurns} |`);
-    });
-    const recommended = estimates.find((e) => e.modelId === recommendedModelId);
-    const recommendedName = recommended?.displayName ?? recommendedModelId;
-    const lines = [
-        '## Estimación de Costo por Modelo IA',
-        '',
-        header,
-        ...rows,
-        '',
-        `## Recomendación: ${recommendedName}`,
-        '',
-        recommendationReason,
-    ];
-    if (staleWarning) {
-        lines.push('', `> **Aviso**: ${staleWarning}`);
-    }
-    return lines.join('\n');
-}
-// ---------------------------------------------------------------------------
 // Main orchestrator
 // ---------------------------------------------------------------------------
 /**

package/dist/engine/ai-cost-estimator/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/core.ts"],"names":[],"mappings":"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"}

package/dist/engine/ai-cost-estimator/recommender.d.ts

@@ -0,0 +1,8 @@
+import type { AiCostEstimate, AiModelConfig } from '../../types/index.js';
+/** Selects the recommended model based on spec complexity. */
+export declare function selectRecommendedModel(models: readonly AiModelConfig[], complexity: 'low' | 'medium' | 'high'): AiModelConfig;
+/** Builds a human-readable recommendation reason. */
+export declare function buildRecommendationReason(model: AiModelConfig, complexity: 'low' | 'medium' | 'high', savingsVsMostExpensive: number): string;
+/** Formats the cost estimates as a markdown table. */
+export declare function formatMarkdownTable(estimates: readonly AiCostEstimate[], recommendedModelId: string, recommendationReason: string, staleWarning: string): string;
+//# sourceMappingURL=recommender.d.ts.map

package/dist/engine/ai-cost-estimator/recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommender.d.ts","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/recommender.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1E,8DAA8D;AAC9D,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GACpC,aAAa,CA8Cf;AAED,qDAAqD;AACrD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,EACrC,sBAAsB,EAAE,MAAM,GAC7B,MAAM,CA0BR;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,cAAc,EAAE,EACpC,kBAAkB,EAAE,MAAM,EAC1B,oBAAoB,EAAE,MAAM,EAC5B,YAAY,EAAE,MAAM,GACnB,MAAM,CAkCR"}

package/dist/engine/ai-cost-estimator/recommender.js

@@ -0,0 +1,94 @@
+// engine/ai-cost-estimator/recommender.ts — Model recommendation and markdown formatting.
+// Extracted from core.ts to keep file sizes within limits.
+/** Selects the recommended model based on spec complexity. */
+export function selectRecommendedModel(models, complexity) {
+    const preferencesByComplexity = {
+        low: [
+            'claude-haiku-3-5',
+            'gemini-2-5-pro',
+            'gpt-4-1',
+            'gpt-4o',
+            'claude-sonnet-4',
+            'claude-opus-4',
+        ],
+        medium: [
+            'claude-sonnet-4',
+            'gpt-4o',
+            'gpt-4-1',
+            'gemini-2-5-pro',
+            'claude-haiku-3-5',
+            'claude-opus-4',
+        ],
+        high: [
+            'claude-opus-4',
+            'claude-sonnet-4',
+            'gpt-4o',
+            'gpt-4-1',
+            'gemini-2-5-pro',
+            'claude-haiku-3-5',
+        ],
+    };
+    const preferences = preferencesByComplexity[complexity] ?? preferencesByComplexity.medium ?? [];
+    for (const modelId of preferences) {
+        const model = models.find((m) => m.id === modelId);
+        if (model) {
+            return model;
+        }
+    }
+    // Fallback: cheapest model
+    /* v8 ignore start */
+    const sorted = [...models].sort((a, b) => a.inputPricePerMillion - b.inputPricePerMillion);
+    const first = sorted[0];
+    if (!first) {
+        throw new Error('No models available in pricing config');
+    }
+    return first;
+    /* v8 ignore stop */
+}
+/** Builds a human-readable recommendation reason. */
+export function buildRecommendationReason(model, complexity, savingsVsMostExpensive) {
+    const complexityLabel = { low: 'baja', medium: 'media', high: 'alta' }[complexity];
+    const baseReason = `Para complejidad ${complexityLabel}, **${model.displayName}** ofrece `;
+    if (complexity === 'low') {
+        return (baseReason +
+            `el mejor precio sin sacrificar calidad. ` +
+            `Ahorro estimado vs modelo más caro: $${savingsVsMostExpensive.toFixed(4)} USD.`);
+    }
+    if (complexity === 'medium') {
+        return (baseReason +
+            `el mejor balance calidad/precio. ` +
+            `Ahorro estimado vs modelo más caro: $${savingsVsMostExpensive.toFixed(4)} USD.`);
+    }
+    return (baseReason +
+        `máxima calidad para specs complejas. ` +
+        `El costo adicional se justifica por la reducción de iteraciones.`);
+}
+/** Formats the cost estimates as a markdown table. */
+export function formatMarkdownTable(estimates, recommendedModelId, recommendationReason, staleWarning) {
+    const header = '| Modelo | Tokens Input | Tokens Output | Costo Estimado | Rango (±) | Agent Turns |\n' +
+        '|--------|-------------|---------------|----------------|-----------|-------------|';
+    const rows = estimates.map((est) => {
+        const marker = est.modelId === recommendedModelId ? ' ⭐' : '';
+        const cost = `$${est.estimatedCostUsd.toFixed(4)}`;
+        const range = `±${est.confidenceRangePct}%`;
+        return (`| ${est.displayName}${marker} | ${est.inputTokens.toLocaleString()} | ` +
+            `${est.outputTokens.toLocaleString()} | ${cost} | ${range} | ${est.agentTurns} |`);
+    });
+    const recommended = estimates.find((e) => e.modelId === recommendedModelId);
+    const recommendedName = recommended?.displayName ?? recommendedModelId;
+    const lines = [
+        '## Estimación de Costo por Modelo IA',
+        '',
+        header,
+        ...rows,
+        '',
+        `## Recomendación: ${recommendedName}`,
+        '',
+        recommendationReason,
+    ];
+    if (staleWarning) {
+        lines.push('', `> **Aviso**: ${staleWarning}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=recommender.js.map

package/dist/engine/ai-cost-estimator/recommender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommender.js","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/recommender.ts"],"names":[],"mappings":"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"}

package/dist/engine/ai-cost-estimator/spec-loader.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Reads spec content from a sdd/specs directory.
+ * Tries to find the spec directory by matching specId prefix.
+ */
+export declare function loadSpecContent(specId: string): Promise<{
+    content: string;
+    specDir: string;
+}>;
+/** Counts acceptance criteria (lines starting with "- [ ]" or "- [x]") in spec content. */
+export declare function countAcceptanceCriteria(specContent: string): number;
+/** Reads average tokens per call from usage.json if available. */
+export declare function readUsageAvgTokensPerCall(): Promise<number | undefined>;
+//# sourceMappingURL=spec-loader.d.ts.map

package/dist/engine/ai-cost-estimator/spec-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-loader.d.ts","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/spec-loader.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA6E/C;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,kEAAkE;AAClE,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7E"}

package/dist/engine/ai-cost-estimator/spec-loader.js

@@ -0,0 +1,102 @@
+// engine/ai-cost-estimator/spec-loader.ts — Loads spec content and counts acceptance criteria.
+// Extracted from core.ts to keep file sizes within limits.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Reads spec content from a sdd/specs directory.
+ * Tries to find the spec directory by matching specId prefix.
+ */
+export async function loadSpecContent(specId) {
+    // Try modern location first, fallback to legacy
+    let specsRoot = 'planu/specs';
+    try {
+        const { access: fsAccess } = await import('node:fs/promises');
+        await fsAccess(specsRoot);
+    }
+    catch {
+        specsRoot = 'docs/sdd/specs';
+    }
+    const { readdir } = await import('node:fs/promises');
+    let specDir = null;
+    try {
+        const topEntries = await readdir(specsRoot);
+        // Try flat layout first: planu/specs/SPEC-069-name/ or docs/sdd/specs/SPEC-069-name/
+        const flatMatch = topEntries.find((e) => e.startsWith(specId));
+        if (flatMatch) {
+            specDir = join(specsRoot, flatMatch);
+        }
+        else {
+            // Try nested layout: planu/specs/{feature}/SPEC-069-name/
+            for (const group of topEntries) {
+                try {
+                    const groupEntries = await readdir(join(specsRoot, group));
+                    const nestedMatch = groupEntries.find((e) => e.startsWith(specId));
+                    if (nestedMatch) {
+                        specDir = join(specsRoot, group, nestedMatch);
+                        break;
+                    }
+                }
+                catch {
+                    // Not a directory — skip
+                }
+            }
+        }
+    }
+    catch {
+        throw new Error(`Spec directory not found at "${specsRoot}". ` +
+            'Make sure you are running from the project root.');
+    }
+    if (!specDir) {
+        throw new Error(`Spec "${specId}" not found in "${specsRoot}". ` + 'Check that the spec directory exists.');
+    }
+    const parts = [];
+    // Try modern names first, fallback to legacy — only read one of each pair
+    for (const [modern, legacy] of [
+        ['spec.md', 'HU.md'],
+        ['technical.md', 'FICHA-TECNICA.md'],
+    ]) {
+        let found = false;
+        for (const filename of [modern, legacy]) {
+            if (found) {
+                break;
+            }
+            try {
+                const content = await readFile(join(specDir, filename), 'utf-8');
+                parts.push(content);
+                found = true;
+            }
+            catch {
+                // File not present — try next
+            }
+        }
+    }
+    if (parts.length === 0) {
+        throw new Error(`Spec "${specId}" has no spec files in "${specDir}". ` +
+            'Cannot estimate without spec content.');
+    }
+    return { content: parts.join('\n\n'), specDir };
+}
+/** Counts acceptance criteria (lines starting with "- [ ]" or "- [x]") in spec content. */
+export function countAcceptanceCriteria(specContent) {
+    const matches = specContent.match(/^- \[[ xX]\]/gm);
+    return matches?.length ?? 0;
+}
+/** Reads average tokens per call from usage.json if available. */
+export async function readUsageAvgTokensPerCall() {
+    try {
+        const { readFile: rf } = await import('node:fs/promises');
+        const raw = await rf('data/global/usage.json', 'utf-8');
+        /* v8 ignore start */
+        const log = JSON.parse(raw);
+        if (log.events.length === 0) {
+            return undefined;
+        }
+        // Usage events don't track token counts — return undefined to use defaults
+        return undefined;
+        /* v8 ignore stop */
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=spec-loader.js.map

package/dist/engine/ai-cost-estimator/spec-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-loader.js","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/spec-loader.ts"],"names":[],"mappings":"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"}

package/dist/engine/ci-generator/planu-config.d.ts

@@ -0,0 +1,7 @@
+import type { PlanuConfigOptions } from '../../types/index.js';
+/**
+ * Generate the YAML content for a .planu.yml configuration file.
+ * This file configures the Planu CI check workflow behavior.
+ */
+export declare function generatePlanuConfigYaml(options: PlanuConfigOptions): string;
+//# sourceMappingURL=planu-config.d.ts.map

package/dist/engine/ci-generator/planu-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planu-config.d.ts","sourceRoot":"","sources":["../../../src/engine/ci-generator/planu-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAkD3E"}

package/dist/engine/ci-generator/planu-config.js

@@ -0,0 +1,40 @@
+// ci-generator/planu-config.ts — Generate .planu.yml config file (SPEC-066 AC-05)
+/**
+ * Generate the YAML content for a .planu.yml configuration file.
+ * This file configures the Planu CI check workflow behavior.
+ */
+export function generatePlanuConfigYaml(options) {
+    const { specsDir, failOnDrift, severityThreshold, postComment, badge, include, exclude, licenseKeyRef, } = options;
+    const lines = ['# .planu.yml — Planu CI configuration', ''];
+    // Specs section
+    lines.push('specs:');
+    lines.push(`  directory: ${specsDir}`);
+    if (include && include.length > 0) {
+        lines.push('  include:');
+        for (const spec of include) {
+            lines.push(`    - ${spec}`);
+        }
+    }
+    if (exclude && exclude.length > 0) {
+        lines.push('  exclude:');
+        for (const spec of exclude) {
+            lines.push(`    - ${spec}`);
+        }
+    }
+    lines.push('');
+    // CI section
+    lines.push('ci:');
+    lines.push(`  fail-on-drift: ${String(failOnDrift)}`);
+    lines.push(`  severity-threshold: ${severityThreshold}`);
+    lines.push(`  post-comment: ${String(postComment)}`);
+    lines.push(`  badge: ${String(badge)}`);
+    // License section
+    if (licenseKeyRef) {
+        lines.push('');
+        lines.push('license:');
+        lines.push(`  key: \${${licenseKeyRef}}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=planu-config.js.map

package/dist/engine/ci-generator/planu-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planu-config.js","sourceRoot":"","sources":["../../../src/engine/ci-generator/planu-config.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAIlF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA2B;IACjE,MAAM,EACJ,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,KAAK,EACL,OAAO,EACP,OAAO,EACP,aAAa,GACd,GAAG,OAAO,CAAC;IAEZ,MAAM,KAAK,GAAa,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;IAEtE,gBAAgB;IAChB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC;IAEvC,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,yBAAyB,iBAAiB,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAExC,kBAAkB;IAClB,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,aAAa,aAAa,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}